package com.example.config;

import com.github.xiaoymin.knife4j.spring.annotations.EnableKnife4j;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Import;
import springfox.bean.validators.configuration.BeanValidatorPluginsConfiguration;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.schema.ScalarType;
import springfox.documentation.service.Contact;
import springfox.documentation.service.ParameterType;
import springfox.documentation.service.RequestParameter;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

import java.util.ArrayList;
import java.util.List;

import static java.util.Collections.singletonList;

/** 接口文档生成配置
 * @author Alex
 * @EnableSwagger2 开启swagger2
 */

@Configuration
@EnableSwagger2
//下面两条是Knife4j引入的，若是只用Swagger可去掉
@EnableKnife4j
@Import(BeanValidatorPluginsConfiguration.class)
public class SwaggerConfig {

    /**
     * Swagger配置 for Knife4j
     * @return
     */
    @Bean(value = "defaultApi")
    public Docket defaultApi() {
        Docket docket=new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(
                        new ApiInfoBuilder()
                                // 文档标题
                                .title("Campus Medicine - API接口文档")
                                // 文档描述信息
                                .description("一个全面的数字平台，用于管理和存储医疗记录、安排预约以及促进校医处和高校师生之间的沟通。")
                                .contact(new Contact("peng_YunJun","https://blog.csdn.net/peng_YuJun?type=blog","pengyujun53@163.com"))
                                // 文档版本号
                                .version("1.0")
                                .build()
                )
                //分组名称
                .groupName("总接口")
                // select()：生成 API 文档的选择器，用于指定要生成哪些 API 文档
                .select()
                //这里指定Controller扫描包路径
                .apis(RequestHandlerSelectors.basePackage("com.example.controller"))
                // paths()：指定要生成哪个 URL 匹配模式下的 API 文档。这里使用 PathSelectors.any()，表示生成所有的 API 文档。
                .paths(PathSelectors.any())
                .build()
                // 配置必传的请求头参数
                .globalRequestParameters(
                    singletonList(new springfox.documentation.builders.RequestParameterBuilder()
                            .name("Authorization")
                            .description("用户token")
                            .in(ParameterType.HEADER)
                            .required(false)
                            .query(q -> q.model(m -> m.scalarModel(ScalarType.STRING)))
                            .build()));
        return docket;
    }

}